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Multics Emacs was modelled after the EMACS editor at the 
Massachusetts Institute of Technology (MIT) Artificial Intelligence 
Lab. EMACS was written, in TECO. by staff members of the MIT AI 
Lab and the MIT Laboratory for Computer Science. without whose 
encouragement and support this project would not have been possible. 


Significant Changes in CP31-00A 


The “S (string-search) request now accepts a numeric argument. 


The *R (reverse-string-search) request now accepts a numeric 
argument. 


The ESC % (query-replace) request now accepts six new responses. 


For purposes of clarity and ease of use, the MPM set has been 
reorganized. The six former MPM manuals, the Tools manual, and 
the RCP Users! Guide have been consolidated into a new set of 
three manuals: pa, REE 


Multics Programmer's Reference Manual (AG91) 
contains all the reference material from the former eight 
manuals. 


Multics Commands and Active Functions (AG92) 
contains all the commands and active Punetions from the 
former eight manuals. 


Multics Subroutines and Input/Output Modules (AG93) 
contains all the subroutines and I/O modules from the 
former eight manuals. 


The following manuals are obsolete: 


Name Order No. 
MPM Peripheral Input/Output AX49 
MPM Subsystem Writers' Guide AK92 
Programming Tools 3 AZ03 
MPM Communications I/0 CC92 
Resource Control Users' Guide CT 38 


References to the old MPM Commands manual still exist on pages 
not published with this addendum. When this manual is revised, 
the references in the text to the old manual will be changed to 
reflect the new organization. 
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‘SECTION 7 


SEARCHES AND SUBSTITUTIONS 


searching is the term applied to the editor's method of locating 
a particular character sequence, or character string. You may 
want to do this simply to move the cursor to a portion of your 
text where some editing is required, or you may be seeking to 
replace a character string with something else. This latter 
replacement of one character string with another is termed 
Substitution. Usyally, the easiest way to make a substitution is 
to search for the string to be replaced, delete it when found, 
and type in the correction. However, occasionally you wish to 
replace a@particular string throughout the buffer; the substitution 
requests serve that purpose. 


SEARCHYNG FOR A CHARACTER STRING 
Emacs provides two requests just for locating a character 
String, whig¢gh you are prompted for. One of these searches forward 


from the current point to the end of the buffer. The other searches 
backward from the current point to the beginning of the buffer. 


“S AND “R 


The “S request is named string-search, and searches forward. 
When you type it, you are prompted: | 


String Search: _ 


T-1  CP31-00 


Type in the characters you wish located, exactly as you expect 
them to appear, including any spaces where required, and terminate 
the prompt with CR. If the search succeeds, the point is left 
immediately after the first occurrence of the character string. 
If no such string is found, the cursor does not move and Emacs 
responds in the minibuffer: 


Search fails. 


Responding to a search request's prompt with only a carriage 
return reuses the last search string supplied (the default search 
String). Thus, you can locate several (or all) occurrences of 
the same string without continually retyping it. 


With a numeric argument, ~S searches forward for the specified 
occurrence of the string; e.g., ESC 5 “S searches forward for the 
5th occurrence of the string. If there aren't 5 occurrences, it 
leaves the point immediately after the last occurrence, and gives 
you a message saying how many occurrences it found. | 


The “Rrequest, reverse-string-search, searches backward through 
the buffer. It works just like “S, except it leaves the point in 
front of the located string (so you do not keep locating en same 
string). Also, itS prompt appears as: 


Reverse String Search: _ : 


With a numeric argument, “R searches backward for the specified 
occurrence of the string. If there aren't that many occurrences, 
it leaves the point in front of the last occurrence, and gives 
you a message Saying how many occurrences it found. 


SUBSTITUTING ONE CHARACTER STRING FOR ANOTHER 


TES EAS PAYEE =— aut EGET 


These next two requests search for a specified character string, 
which you are.prompted for, and replace it with another, also 
prompted for. 
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ESC X replace and ESC % 


The ESC X replace extended request substitutes one string for 
another at all occurrences of the first string between the current 
point and the buffer's end. You are prompted for the string to 
be replaced, and then for the string that is to replace it. If 
no occurrences of the first string are found, the cursor does not 
move. Otherwise, the point is left after the last substituted 
string. | 


The ESC 4% request, query-replace, allows you to substitute 
one string for another selectively. You are prompted for the 
search string and the replacement string individually; end each 
prompt with CR. This request searches forward for the first string, 
puts the point after it, and waits for one of the following responses 
(type the appropriate keys): 


Space 
replaces this occurrence of the first string with the 
second. Then searches for the next occurrence of the 
first string and waits for a response again. 

CR 
leaves this occurrence of the first string unchanged and 
searches for the next occurrence of the first string, 
again waiting for a response after locating it. 


(period) 


replaces this occurrence of the first string with the 
second and then terminates the query replace. 


leaves this occurrence of the first string unchanged and 
terminates the query replace. 


ESC 


same as “G. 


replaces all occurrences of the first string from the 
current point to the end, without querying again. 
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, (comma) 


replaces this occurrence of the first string with the 
second, immediately updating the screen. Then searches 
for the next occurrence of the first string and waits for 
a response again. 


ae 
redisplays the screen. 
displays a description of the allowable responses (i.e., 
prints this list). 

sa 


same as ~ 


SUMMARY OF REQUESTS 
“S string-search 
“R reverse-string-search 
(ESC X) replace 


ESC 4% query-replace 
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